.TH "secolor.conf" "5" "08 April 2011" "SELinux API documentation"
.SH "NAME"
secolor.conf \- The SELinux color configuration file
.
.SH "DESCRIPTION"
This optional file controls the color to be associated to the context components associated to the 
.I raw
context passed by 
.BR selinux_raw_context_to_color "(3),"
when context related information is to be displayed in color by an SELinux-aware application. 
.sp
.BR selinux_raw_context_to_color "(3)"
obtains this color information from the active policy 
.B secolor.conf
file as returned by 
.BR selinux_colors_path "(3)."
.
.SH "FILE FORMAT"
The file format is as follows:
.RS
.B color
.I color_name
.BI "= #"color_mask
.br
[...]
.sp
.I context_component string
.B =
.I fg_color_name bg_color_name
.br
[...]
.sp 
.RE

Where:
.br
.B color
.RS
The color keyword. Each color entry is on a new line.
.RE
.I color_name
.RS
A single word name for the color (e.g. red).
.RE
.I color_mask
.RS
A color mask starting with a hash (#) that describes the hexadecimal RGB colors with black being #000000 and white being #ffffff.
.RE
.I context_component
.RS
The context component name that must be one of the following:
.br
.RS
user, role, type or range 
.RE
Each
.IR context_component " " string " ..."
entry is on a new line.
.RE
.I string
.RS
This is the 
.I context_component
string that will be matched with the 
.I raw
context component passed by
.BR selinux_raw_context_to_color "(3)."
.br
A wildcard '*' may be used to match any undefined string for the user, role and type 
.I context_component
entries only.
.RE

.I fg_color_name
.RS
The color_name string that will be used as the foreground color.
A 
.I color_mask
may also be used.
.RE
.I bg_color_name
.RS
The color_name string that will be used as the background color.
A 
.I color_mask
may also be used.
.RE
.
.SH "EXAMPLES"
Example 1 entries are:
.RS
color black  = #000000
.br
color green  = #008000
.br
color yellow = #ffff00
.br
color blue   = #0000ff
.br
color white  = #ffffff
.br
color red    = #ff0000
.br
color orange = #ffa500
.br
color tan    = #D2B48C
.sp
user * = black white
.br
role * = white black
.br
type * = tan orange
.br
range s0\-s0:c0.c1023 = black green
.br
range s1\-s1:c0.c1023 = white green
.br
range s3\-s3:c0.c1023 = black tan
.br
range s5\-s5:c0.c1023 = white blue
.br
range s7\-s7:c0.c1023 = black red
.br
range s9\-s9:c0.c1023 = black orange
.br
range s15\-s15:c0.c1023   = black yellow
.RE

.sp
Example 2 entries are:
.RS
color black  = #000000
.br
color green  = #008000
.br
color yellow = #ffff00
.br
color blue   = #0000ff
.br
color white  = #ffffff
.br
color red    = #ff0000
.br
color orange = #ffa500
.br
color tan    = #d2b48c
.sp
user unconfined_u = #ff0000 green
.br
role unconfined_r = red #ffffff
.br
type unconfined_t = red orange
.br
user user_u       = black green
.br
role user_r       = white black
.br
type user_t       = tan red
.br
user xguest_u     = black yellow
.br
role xguest_r     = black red
.br
type xguest_t     = black green
.br
user sysadm_u     = white black
.br
range s0-s0:c0.c1023 = black white
.br
user *            = black white
.br
role *            = black white
.br
type *            = black white
.RE
.
.SH "SEE ALSO"
.BR selinux "(8), " selinux_raw_context_to_color "(3), " selinux_colors_path "(3)"
